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Abstract 

This note is the technical reference for the VTEC adapter, a Versatec plotter op- 
tion module for TurboChannel I/O systems. It implements the Versatec Parallel 
Interface (VPI) and can control all models of Versatec plotters. 

This adapter is a research prototype; it is not a product. 
Copyright © 1992 Digital Equipment Corporation 
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1. Introduction 



The VTEC adapter is a Versatec plotter option module for TurboChannel I/O systems. It 
implements the Versatec Parallel Interface (VPI) and can control all models of Versatec plotters. 
The adapter was designed to allow a workstation to act as a plotter server for a network of other 
workstations. This adapter hardware and its device driver software implement a Unix line 
printer device which can be controlled by the standard Unix line printer software (lpr, lpc, lpd, 
printcap, etc) [1]. Figure 1 shows a typical configuration. 
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Figure 1: A Typical Configuration 



2. Installation Information 

Figure 2 is a full-scale drawing of the adapter, a single-slot TurboChannel option module. It 
uses programmed I/O, not DMA, and occupies 4 MBytes of address space. Power consumption 
is less than 1 Amp at 5 Volts = 5 watts; no 12 Volt power is used. There are no jumpers or 
switches to configure; just plug it in. 

The maximum data rate at the VPI interface is typically 1 MByte/sec. The maximum data rate 
of the VTEC adapter is about 1.5 MBytes/sec. The maximum data rate of an Ethernet is 1.25 
MBytes/sec. So a Versatec plotter controlled by a VTEC adapter installed in a computer con- 
nected to an Ethernet is a balanced system: data can arrive at the server via the Ether at about 
the same rate that it can depart for the plotter via the VPI. 

One data byte is transferred to the adapter on each I/O write. 2K bytes are transferred to the 
adapter on each interrupt. So at the peak data rate of 1 MByte/sec, the adapter will generate 500 
interrupts per second. If the CPU can't keep up (that is, if it can't take an interrupt, transfer 2K 
bytes, and dismiss the interrupt in less than 2 milliseconds), then the plotter will simply slow 
down, degrading gracefully. 8K FIFO chips are just coming on the market (they cost $75 each) 
but they permit 4K bytes to be transferred per interrupt, halving the maximum interrupt rate from 
500/sec to 250/sec. 
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Figure 2: Option Module Layout 

A plotter server system should spool arriving plots on a local disk, not a disk accessed over 
the Ethernet. If the spool disk is out on the Ethernet, then plot data will move through the Ether 
three times before being plotted. The spool disk doesn't have to be very big: just big enough to 
hold the plot in progress, plus any other plot jobs that arrive while the plotter is busy. One or 
two hundred megabytes of local disk should suffice for most configurations. 



3. What is a Versatec Parallel Interface? 

The Versatec Parallel Interface (VPI) [5] is an 8-bit parallel data transport method that moves 
graphic, control, and character data from an adapter to a plotter or printer. The signalling is 
EIA-422 [4] (differential TTL levels) and handshaking between adapter and plotter is done on a 
byte -by-byte basis. 
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The cable between adapter and plotter is 19 twisted pairs with a characteristic impedance of 
about 120 ohms; maximum length is about 1000 feet. 37-pin D-subminiature cable connectors 
are used (DC-37), the adapter has a female connector with screw-locks and plotters have male 
connectors with bail-mount locks. 

Figure 3 shows the byte-by-byte handshaking protocol at the VPI interface. If the plotter is 
READY then the adapter can set up a data byte and assert PICLK (parallel interface clock). 
PICLK must be asserted for a minimum of 300 ns, and must not be deasserted until READY 
drops. 
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Figure 3: VPI timing diagram 

Four signals in the VPI are used by an adapter to remotely control a plotter. These signals 
must only be asserted singly, and they use a protocol similar to the data handshake, but instead of 
P ICLK the remote control signal itself is asserted until READY drops and then it is dropped. The 
exact behavior of a remote command depends on the model; consult the plotter manual. 

• The FF remote control signal moves paper a predetermined distance after a plot is 
complete (formfeed). 

• The CLR remote control signal clears the scan line buffer in the plotter. 

• The EOL remote control signal ends a scan line. Subsequent data starts filling the 
next scan line. 

• The EOP remote control signal ends a plot job. It moves the paper so the plot is 
outside of the imaging mechanism, and then shuts down the plotter. 

Many plotter models have a built-in character generator and can print character data as well as 
plot raster data. The MODE signal in the VPI modifies the interpretation of the eight data signals. 
If MODE is true, then the data signals are an ASCII character code, otherwise they are raster data 
bits. The first byte of a scan line is on the left and the most significant bit of a data byte is the 
leftmost bit when plotted. Newer model plotters use ASCII escape sequences to control special 
functions (e.g. color selection) that were not anticipated when the original four remote control 
signals were defined. 

I NOP is the only other signal from the plotter to the adapter besides READY. It is true if the 
plotter power is off, or the cable from adapter to plotter is unplugged. 
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4. What is a TurboChannel? 

A TurboChannel is a synchronous asymmetric input/output bus designed by Digital Equip- 
ment Corporation for use in workstations [3]. It is synchronous because there is a global clock 
whose rising edge is the reference for all bus signals. It is asymmetric because there is one 
system module and some number of option modules connected to it. The system module can 
read and write the option modules, and option modules can read and write the system module, 
but option modules can't talk to each other. 

When a program running in the system module executes a load or store instruction whose 
effective address falls within the address space of an option module, an I/O read or I/O write bus 
transaction is performed. The system module asserts a signal selecting an option module, and 
places an address on the 32-bit address/data bus, which the option module saves in a register. In 
the next cycle the system module reads or writes a word; if the option module is not ready, it can 
assert a signal to stall the transaction. A DS5000/200 can do 5 I/O writes or 2 I/O reads per 
microsecond. The VTEC adapter requires one I/O write per microsecond when going full speed. 

An option module can read and write main memory via the system module by performing a 
Direct Memory Access or DMA bus transaction. An option module asserts a read or write signal 
to start a DMA operation, and then waits for an acknowledgement from the system module. 
Upon receipt of an ack, the option module drives an address onto the bus and then writes, or after 
a pause, reads 32-bit words on each succeeding cycle, for a peak bandwidth of 100 MBytes/sec 
(one 32-bit word every 40 ns = 800 Mbits/sec = 100 MBytes/sec). At 200 KBytes/sec typical, 1 
MByte/sec max, this adapter does not use DMA. 

There is nothing more to the TurboChannel; it is refreshingly simple. Many of DEC's I/O 
buses are asynchronous and symmetric, making them slow and complex, and raising the cost to 
implement simple devices. 

5. Technical Description 

Figure 4 is a block diagram of the adapter. Data flows from the TurboChannel, through bus 
transceivers into a 4 KB FIFO, and out through the VPI line drivers. 

• IOADDR is a 16-bit register that holds the address during a TurboChannel trans- 
action. 

• PROM is a 32KB EPROM containing TurboChannel configuration information and 
diagnostic programs. 

• TCCTL is a PAL containing a finite state machine which handles TurboChannel bus 
transactions. 

•TCCSRisa PAL containing the TurboChannel control and status register. 

• FIFO is a 4KB FIFO buffer between the TurboChannel interface and the Versatec 
Parallel Interface. 

• VPCTL is a PAL containing a finite state machine which handles Versatec Parallel 
Interface transactions. 
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Figure 4: Block Diagram 

• VP RMT is a PAL containing the VPI remote control signals. 

• READY and I NOP from the plotter are synchronized to the adapter clock before go- 
ing to the VPCTL FSM. 

Remote control commands are issued, and the print/plot mode bit is manipulated by writing a 
byte into the FIFO with the ninth bit set. When such a byte emerges from the FIFO on the 
Versatec side, it is acted upon by the Versatec FSM. By passing remote commands and mode 
changes through the FIFO, they get executed in the proper order relative to surrounding data 
bytes. The mode bit appears as a read-only bit in the CSR. 

6. Programming Interface 

The VTEC adapter is a programed I/O device; it does not use DMA. A device driver com- 
municates with the adapter by executing load and store instructions whose effective addresses 
are within the adapter's 4 MByte address space. 

There are three regions in the adapter address space: control/status, data, and option rom. 

• The Control/Status Register (CSR) is a single address. Some of the bits in this 
register are read-only, such as FIFO status, and some are read/write, such as inter- 
rupt enable. 

• The Data Register is a single address to which bytes are written. Bytes are either 
data to be plotted or remote control functions to be performed. 

• The Option ROM occupies 128K addresses in the adapter's space. It contains infor- 
mation about the adapter (type, manufacturer, revision level, etc) and diagnostic 
programs that can be loaded into memory and executed under the ROM Executive. 
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6.1. Control/Status Register 

The control/status register, figure 5, is addressed when the adapter is selected and address bits 
17 and 2 are one. Other address bits are ignored, so many other I/O addresses also reference the 
CSR. 

31 9 8 

I I I 

| Ignored I 1 | 

I I I 

Bits 31.. 9: no connection. 
Bit 8 - always reads one . 
Bit 7 - always reads one . 

Bit 6 - Mode; read-only; cleared by hardware reset. 

One if in PRINT mode, zero if in PLOT mode. 

Changed by software writing a control byte to the FIFO. 
Bit 5 - Inoperative; read-only; unaffected by hardware reset. 

One if device power is off or cable is unplugged. 
Bit 4 - Fifo Empty; read-only; set by hardware reset. 

One if the FIFO is empty. 
Bit 3 - Fifo Half; read-only; cleared by hardware reset. 

One if the FIFO is more than half full (2049-4096 bytes) . 
Bit 2 - Fifo Full; read-only; cleared by hardware reset. 

One if the FIFO is full. 
Bit 1 - Interrupt Enable; read-write; cleared by hardware reset. 

Set by software to permit the adapter to cause interrupts. 
Bit 0 - Reset; read-write; cleared by hardware reset. 

Set and then cleared by software to reset adapter and device. 

Figure 5: Control/Status Register (CSR) 

csr . mode is the Versatec print/plot mode bit. It is set by writing the remote control register 
(see below). 

csr . in op is true if the plotter is turned off or the cable between adapter and plotter is un- 
plugged. While csr . in op is true, an interrupt is generated if enabled. 

The three FIFO bits indicate the status of the FIFO. After a reset, csr . f if oEmpt will be 
true and the other two will be false. While csr.fifoHalfis false, an interrupt is generated if 
enabled. Normally, software fills the FIFO and then enables interrupts. When half of the bytes 
in the FIFO have been sent to the plotter, csr.fifoHalf goes false, an interrupt occurs, and 
software fills up the FIFO again. As long as the FIFO never runs dry, the plotter runs at full 
speed. 

The adapter can be operated without interrupts by clearing csr.IntEnbl and polling 
csr.fifoHalf and csr . in op. In addition to the Interrupt Enable bit in the adapter CSR, a 
bit in a CPU register must be set for interrupts to occur. csr.fifoHalf must be one and 
csr . in op must be zero before enabling interrupts or else an interrupt will immediately happen. 

csr . reset empties the FIFO, resets the finite state machines, and asserts the RESET signal 
in the VPI. Software sets and then clears this bit to reset everything; this is a drastic action. 



76543210 

I I I I I I I 

1 | Mode | In | Fifo | Fifo I Fifo | Int I Re 
I | Op | Empt | Half I Full | Enbl I Set 
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6.2. Data Register 

The data register, figure 6, is addressed when address bit 17 is one, bit 2 is zero, and data bit 8 
is zero. Other address bits are ignored, so many other I/O addresses also reference the data 
register. 

31 9 8 7 

+ + + 

I I I 

| Ignored | 0 I DATA 

I I I 

+ + + 

Bits 31.. 9: no connection. 
Bit 8 : must be zero 

Bits 7. .0: Data - byte to be plotted or printed 

Figure 6: Data Register 

A byte written to the data register goes into the FIFO. When it emerges on the Versatec side, 
because bit 8 is zero, it is driven onto the VPI data lines with a handshake. The plotter will 
interpret the byte as character data to be printed or raster data to be plotted depending on MODE. 



o 

— + 



6.3. Remote Control Register 



The remote control register, figure 7, is addressed when address bit 17 is one, bit 2 is zero, and 
data bit 8 is one. Other address bits are ignored, so many other I/O addresses also reference the 
remote control register. 
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5 4 3 2 1 
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I I I I 

Mode | CLR| FF | EOL| 

III 



EOF 



Bits 31 . . 
Bit 8 : 
Bits 7 . . 6 
Bit 5 . . 4 : 

Bit 3 
Bit 2 
Bit 1 
Bit 0 



9: 



CLR 
FF 
EOL 
EOP 



no connection. 

must be one 

no connection. 

Mode - 11 = PRINT mode; 10 

Clear Scan Line Buffer 

Form Feed 

End of Scan Line 

End of Plot 



PLOT mode; OX = no change. 



Figure 7: Remote Control Register 



A byte written to the remote control register goes into the FIFO. When it emerges on the 
Versatec side, because bit 8 is one, MODE is changed or a remote command is issued. To issue a 
remote control command, set the mode field to zero and set the desired remote command bit. 
Only one remote command bit (CLR, FF, EOL, or EOP) should be set at a time. MODE must not 
be changed when a command bit is set. MODE is only changed if bit 5 is one; this permits 
changing a remote control bit without having to refresh the mode bit value. 
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6.4. Option ROM 

The 32 KByte Option ROM occupies the lowest 128 KBytes of adapter address space. The 
Option ROM is addressed when the adapter is selected and address bit 17 is zero. Address bits 
21.. 18 are ignored so there are many other I/O address ranges which also reference the ROM. 
Address bits 16. .2 select a location in the ROM. Address bits 1..0 are ignored because I/O 
references are to 32-bit words. Consecutive ROM bytes are the least significant bytes of con- 
secutive 32-bit words. 

The Option ROM has two parts: fixed-format configuration information and variable-format 
objects such as scripts, and executable code. System module firmware called the ROM 
Executive, or REX, can interpret the script objects and execute the code objects. Rather than 
reprogramming a ROM for each new version during development, REX can be directed to read 
an Option ROM image from an Ethernet boot server rather than from the ROM on the Option 
module. A Unix program written in Modula-2 generates the PROM programmer file and the 
net-bootable file. 

REX loads a code object at a fixed address in memory and transfers control to it, passing a 
callback vector, an array of utility procedures which the code object can use to print messages on 
the console, etc. There is only one code object in this adapter's Option ROM, a keyboard-driven 
diagnostic program written in Modula-2. The program is loaded in the cached kernel memory 
region because it runs about four times faster than uncached. 

To use an Option ROM image booted from the net rather than the ROM on the adapter, 
register the file with a boot server, and use the undocumented REX command boot -D n 
6/tf tp, where n is the slot number of the adapter whose ROM is to be replaced (6/mop works 
too). REX commands invoking code objects will read this image rather than the adapter ROM 
until REX is reinitialized. 

7. Diagnostic Program 

The diagnostic program is started by typing t n to the REX prompt of >>, where n is the 
TurboChannel slot number of the adapter to be tested; i.e. t 0 starts the diagnostic program of 
an adapter in slot zero. 

The diagnostic is a keyboard-driven program which is used to debug adapters and test Ver- 
satec plotters without the complication of going through an operating system. Typing "?" lists all 
of the commands; typing "help" prints a list of the commands along with one-line descriptions. 
To invoke a command, type an unambiguous initial substring terminated by a carriage return or 
space. To stop a running command, type any character. 

• The Quit and Exit commands leave the adapter diagnostic program and return to the 
ROM Executive. 

• The TestPattern command prints graph paper. The plot is 4096 by 4096 bits with 
vertical and horizontal lines every 128 bits. This command should ask the user for 
the dimensions of the plotter, and it should generate more thorough test patterns. 

• The Reset command clears the adapter and the Versatec plotter. It resets the FIFO, 
making it empty. It resets the VPI finite state machine if it is hung waiting for 
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READY. It is passed on to the plotter, where its effects depend on the plotter model; 
consult the manual. 

• The Status command prints the contents of the Control/Status Register (CSR) as a 
hex number and as named fields. 

• The Mode command toggles the print/plot mode bit in the Versatec Parallel Inter- 
face. 

• The FormFeed command issues a form feed command to the plotter by asserting the 
form feed signal in the Versatec Parallel Interface. 

• The Interrupt command tests the interrupt generation logic. It resets the adapter, 
making the FIFO empty, which is a reason to interrupt. It enables interrupts by 
setting the bit in the CSR, and then it asks REX if it sees an interrupt from this slot. 

• The ScopeLoop command continuously reads the control and status register. 
ScopeLoop is terminated by typing any character. This command generates steady 
oscilloscope pictures for debugging the TurboChannel control logic. 

8. Unix Installation 

The device driver was written and debugged for the MIPS architecture version of Ultrix ver- 
sion 4.2. It is very simple and only uses a few basic Unix kernel routines, so it should be easy to 
port. This explanation assumes that an Ultrix kernel-building directory tree exists with a top- 
level directory named sys. This example will define three adapters installed in any slots. 
Volume six of the Ultrix Software Development documentation is a comprehensive manual on 
how to build device drivers [2]. 

Install the two source files: 

File name Directory 

vtec.c sys/io/tc 
vtecioctl.h sys/h, /usr/include 

Add the following line to sys/conf /mips/files .mips: 

io/tc/vtec.c optional vtec device-driver Notbinary 

Add the following lines to sys/conf /mips/VERSATEC (or whatever you call your kernel 
configuration): 

device vtecO at ibus? vector vtec_intr 

device vtecl at ibus? vector vtec_intr 

device vtec2 at ibus? vector vtec_intr 

Add the following line to sys/data/tc_option_data . c after the comment "add any 
new devices or controllers here": 

{ "VTEC-AA ", "vtec", 0, 1, 'D', 0}, 

Add the following lines to sys/machine/common/conf . c: 
#include "vtec.h" 
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#if NVTEC > 0 

int vtec_open(), vtec_close ( ) , vtec_write ( ) , vtec_ioctl C 
#else 

#define vtec_open nodev 
#define vtec_close nodev 
#define vtec_write nodev 
#define vtec_ioctl nodev 
#endif 



Also in sys/machine/common/conf . c, add the following lines to the cdevsw table: 
The index of the table entry (83 in this example) defines the major device number of the adapter. 

{vtec_open, vtec_close, nodev, vtec_write, 

vtec_ioctl, nodev, nodev, 0, 

seltrue, nodev, 0, 0} /* 83 */ 

To make the new vmunix, type the following lines: 

cd sys/conf /mips 
config VERSATEC 
cd sys/MIPS/VERSATEC 
make depend all 

As superuser, type the following commands: This creates three character special inodes 
with the major device number from cdevsw (above), and minor device numbers 0, 1, and 2. 

cd / dev 

mknod vtecO c 83 0 

mknod vtecl c 83 1 

mknod vtec2 c 83 2 

After creating the inodes, check them by typing Is -1 /dev/vtec*: 

crw-rw-r— 1 root 83, 0 May 10 15:23 /dev/vtecO 

crw-rw-r— 1 root 83, 1 May 10 15:23 /dev/vtecl 

crw-rw-r — 1 root 83, 2 May 10 15:23 /dev/vtec2 

Add the following lines to /etc/printcap: The versatec filter, /usr/lib/vdmpc is a 
local program which reads site-specific Versatec-format files and writes them to the adapter. It 
is invoked by the line printer daemon if the -v switch is passed to lpr. It might accept ras- 
terized bitmap files, or it might accept higher-level formatted files and rasterize them itself. 
px# 8 0 0 0 declares that there are 8000 bits per scan line; py#2 4 0 0 declares that for accounting 
purposes a "page" is 2400 scan lines. Consult your plotter manual for the correct value of px. 

versatecO : \ 

: lp=/ dev/ vtecO : mx#0 : \ 

:px#8000 :py#2400 : \ 

: vf =/usr/lib/vdmpc : \ 

: of =/usr/lib/vpf : \ 

: If =/usr/ adm/ versatec0.1og:\ 

: af =/usr/ adm/ versatecO . acct : \ 

:sd=/usr/spool/printq/ versatecO: 
versatecl : \ 

: lp=/ dev/ vtecl : mx#0 : \ 

:px#8000 :py#2400 : \ 
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: vf =/ usr/lib/ vdmpc : \ 
: of =/usr/lib/vpf : \ 
: If =/usr/ adm/ versatecl.log:\ 
: af =/usr/ adm/ vers at eel . acct : \ 
: sd=/usr/ spool /print q/ver sat eel : 
versatec2 : \ 

: lp=/ dev/ vtec2 : mx#0 : \ 

:px#8000 :py#2400 : \ 

: vf=/usr/ lib/ vdmpc : \ 

:of=/usr/lib/vpf:\ 

: If =/usr/ adm/ versatec2.1og:\ 

: af =/usr/ adm/ versatec2 . acct : \ 

:sd=/usr/spool/printq/versatec2: 

This is what you would see after typing Is -1 /usr/spool/printq/versatecO 
when a plot was waiting for versatecO to be available: 

-rw-rw 1 root 130 May 10 15:22 cf AO 3 1 scrooge 

-rw-rw 1 root 32001024 May 10 15:22 df AO 3 1 scrooge 

-rw-rw 1 root 10 May 9 15:31 init 

-rw-r— r— 1 root 30 May 10 15:23 lock 

-rw-rw-r— 1 root 46 May 10 18:14 status 

It is easy to confuse physical TurboChannel slot numbers and logical Unix minor device num- 
bers. The diagnostic program deals in physical TurboChannel slot numbers, which are stenciled 
on the rear bulkhead of the computer. Unix deals in logical device numbers which it calls minor 
device numbers. When Unix boots, it discovers I/O devices by interrogating the ROM in each 
TurboChannel slot, starting at physical slot 0. The first Versatec adapter that it encounters be- 
comes minor device 0, the second one becomes minor device 1, etc. If the first Versatec adapter 
is plugged into TurboChannel slot 1, then Unix will call it vtecO, even though the adapter is in 
slot 1. 
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